home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD v2.1 / Amiga Developer CD v2.1.iso / DevInfo / RequiredReading < prev    next >
Text File  |  1996-07-13  |  7KB  |  177 lines
  1.  
  2.     $Id: RequiredReading 1.1 1996/07/13 20:14:54 heinz Exp $
  3.  
  4. Developing for AmigaOS or Amiga hardware is not more difficult than
  5. for most other platforms. Some information is very basic, though,
  6. and every developer should have it at hand if in any way possible.
  7.  
  8. While the list of information below is not endorsed by Amiga
  9. Technologies, all the sources listed contain information that might
  10. still be helpful and are sometimes used by Amiga Technologies
  11. themselves.
  12.  
  13.     *** PLEASE USE DISCRETION WHEN SEPARATING CURRENT AND UPWARDS
  14.     *** COMPATIBLE INFORMATION FROM OLD OBSOLETE AND POTENTIALLY
  15.     *** DANGEROUS COMMENTS.
  16.  
  17. The comments describing the sources' contents are purely the
  18. personal opinion of the author of this text.
  19.  
  20. This is a list of books and other sources that contain useful and
  21. important information. Some of them are fairly common, some of them
  22. might be hard to come by these days. Some of them might only be
  23. available to you if you know a good friend of a friend who might
  24. have a copy. Some contain old information that might not be
  25. applicable any longer but may still be helpful when it comes to
  26. better understanding the background of things. Those are marked as
  27. "HISTORIC INFO" below. Note that "better understanding" does not
  28. mean that everything mentioned is meant to be used or will stay
  29. that way.
  30.  
  31. Books containing information about software aspects are marked
  32. "SW". Books containing hardware information are marked "HW". Please
  33. be very careful with any use of hardware information as hardware
  34. features are subject to change much more than the OS API.
  35.  
  36.     *** You are urged to use all the information listed here with
  37.     *** discretion. Use your good judgement and avoid grey and/or
  38.     *** undocumented areas of the Amiga. Stay upwards compatible!
  39.     *** Do not create any hacks and don't play dirty tricks!
  40.     *** Avoid assembler stunts. They are inherently unportable.
  41.  
  42. You don't have to have all of the information listed below. But the
  43. more information you read, the better you can do things without
  44. violating Amiga programming rules.
  45.  
  46. First, the RKM series, the official documentation for the OS up to
  47. and including V37, i.e. OS2.04. These books do not explicitely
  48. cover the current V40 release but are the basis for any
  49. documentation on V40. They contain valid information.
  50.  
  51.     AMIGA ROM Kernel Reference Manual LIBRARIES, 3rd Edition.
  52.     Addison-Wesley Publishing Company, Inc.
  53.     ISBN 0-201-56774-1
  54.  
  55.         [SW]
  56.         This book is a *MUST*. It not only contains most of the
  57.         information relevant to the OS, but also very important
  58.         introductory texts, troubleshooting guides, and
  59.         compatibility hints.
  60.  
  61.  
  62.     AMIGA ROM Kernel Reference Manual DEVICES, 3rd Edition.
  63.     Addison-Wesley Publishing Company, Inc.
  64.     ISBN 0-201-56775-1
  65.  
  66.         [SW]
  67.         This book is also a *MUST*. It contains information about
  68.         all the devices and resources and also documents the IFF
  69.         standard.
  70.  
  71.  
  72.     AMIGA User Interface Style Guide
  73.     Addison-Wesley Publishing Company, Inc.
  74.     ISBN 0-201-57757-7
  75.  
  76.         [SW]
  77.         This book is a *MUST*. It documents the conventions that
  78.         must be followed when writing applications for the entire
  79.         line of Amiga computers.
  80.  
  81.  
  82.     AMIGA ROM Kernel Reference Manual Includes and Autodocs, 3rd Edition.
  83.     Addison-Wesley Publishing Company, Inc.
  84.     ISBN 0-201-56773-3
  85.  
  86.         [HISTORIC INFO,SW]
  87.         This contains is a complete reference to all the functions
  88.         and data structures in the Amiga operating system. It might
  89.         come in handy, though more current versions of the contents
  90.         are available in electronic form as part of a current
  91.         Native Developer Kit (NDK), like the current issue of the
  92.         Amiga Developer CD (ADCD).
  93.  
  94.  
  95.     AMIGA ROM Kernel Hardware Reference Manual, 3rd Edition.
  96.     Addison-Wesley Publishing Company, Inc.
  97.     ISBN 0-201-56776-8
  98.  
  99.         [HISTORIC INFO,HW]
  100.         This book is not really a must. It contains information
  101.         about the hardware used in all Amiga models up to and
  102.         including the A3000. It might be of interest to hardware
  103.         designers or for better understanding of some things. It
  104.         should not be used as base for any software development as
  105.         the hardware used in Amiga computers is changing and will
  106.         continue to change. In fact some of the hardware described
  107.         in the book might not even be available anymore in current
  108.         Amigas once you read this! You are *STRONGLY* urged to use
  109.         the OS functions instead of hitting HW that may not be
  110.         there!
  111.  
  112.  
  113.     The Amiga Guru Book, a reference manual
  114.     1993
  115.     Ralph Babel, Falkenweg 3, D-65232 Taunusstein, Germany
  116.     [Available through some international distributors, too.]
  117.  
  118.         [SW]
  119.         This book is a *MUST*. It is currently the most complete
  120.         reference to AmigaDOS, the disk operating system part of
  121.         AmigaOS. Other important information is also contained in
  122.         this book. Use the detailed information with discretion.
  123.         Don't play any dirty tricks with it.
  124.  
  125.  
  126.     Commodore Amiga A500/A2000 Technical Reference Manual
  127.     [Published by C= in '86. Probably close to impossible to come by these
  128.      days]
  129.  
  130.         [HISTORIC INFO,HW]
  131.         This book describes the hardware of the old A500/A2000
  132.         models. You'll also find comments on Zorro-II design
  133.         issues and Autoconfiguration(tm) information. It might
  134.         still be interesting to the hardware designer who wants to
  135.         know how things evolved. Hardly anything in this book is of
  136.         actual importance regarding current development, though.
  137.  
  138.  
  139.     The AmigaDOS Manual, 3rd Edition.
  140.     Bantam Books, Inc.
  141.     ISBN 0-553-35403-5
  142.  
  143.         [SW]
  144.         This book was the official Commodore AmigaDOS reference.
  145.         You don't really need this book if you have The Amiga Guru
  146.         Book. It might be interesting, though, provided you can
  147.         still obtain a copy.
  148.  
  149.  
  150.     Native Developer Kit (NDK)
  151.     Amiga Technologies
  152.     [Version depends on current developments]
  153.  
  154.         [SW,HW]
  155.         A *MUST*. An NDK contains the most current information
  156.         available about AmigaOS in electronic form. As of this
  157.         time, the 3.1 NDK is the most current one, describing
  158.         release 3.1 of AmigaOS. If you want to keep up to date on
  159.         development, you'll need a current NDK.
  160.         Amiga Technologies will make current NDK's available
  161.         whenever possible. A superset of the previously released
  162.         NDKs by C0 can be found on the current ADCD, which is even
  163.         cheaper than the original NDK's used to be.
  164.  
  165.  
  166.     Amiga Mail
  167.     Amiga Technologies
  168.  
  169.         [SW,HW]
  170.         Amiga Mail was the Commodore newsletter for developers. Old
  171.         and relevant issues of Amiga Mail will be made available if
  172.         possible. Check the current ADCD!
  173.  
  174.  
  175. Heinz Wrobel
  176. <heinz@amiga.de>
  177.